---

Wired Movies and Sprites

| Previous | Chapter Contents | Chapter Top | Next |

Constant descriptions

kActionGoToURL

none Param1: [C string]

If the movie is currently being presented using the Web browser plug-in, this causes the browser to go to the specified URL. If the movie is being presented by MoviePlayer, a Web browser is launched and goes to the specified URL. You may optionally specify a particular frame within a Web page.

To specify a URL, use the standard Web address format--for example, http://www.apple.com. You may optionally use angle brackets--for example, <http://www.apple.com>. To specify a particular frame within a URL, you must use angle brackets followed by T<frameName>--for example, <http://www.apple.com>T< frameName >.

kActionSendQTEventToSprite

none Param1: [(SpriteTargetAtoms)] Param2: [QTEventRecord theEvent]

Sends theEvent to the sprite specified by SpriteTargetAtoms . You may send any event to a sprite, including a custom event that you define. Note that kActionSendQTEventToSprite has no target, since it is handled by the system, although you do specify a target Param1 for the event that it sends Param2.

When sending a custom event, make sure the events constant does not conflict with an existing event. If you need to share a complicated event handler among many sprites, you may wish to define a custom event handler on a single sprite and have the others send it the custom event using kActionSendQTEventToSprite .

kActionApplicationNumberAndString

none Param1: [long aNumber] Param2: [Str255 aString]

QuickTime does nothing when this action is executed; it is intended to be used by applications that wish to "hook" it, using the movie contoller's MCSetActionFilter routine with the new constant mcActionExecuteOneActionForQTEvent . Applications may look at the number and string parameters to determine what they want to do when the action is executed.

kActionDebugStr

none Param1: [Str255 theString]

Passes theString through the movie controller's filter proc using the mcActionShowMessageString constant.

Applications that wish to display the message string may use the movie controller's MCSetActionFilter routine along with the new constant mcActionShowMessageString in order to receive the string. QuickTime does not display the string.

Your application can intercept actions using the movie controller's filter procedures. This action serves as a placeholder, so that your application can look for actions of this type with an aNumber or aString parameter that identifies the application. QuickTime will not do anything in response to this action. Your application can then do anything it wants in reponse to the action. If your application is an authoring tool, for example, you could set the values of the aNumber and aString parameters. This is currently the only action that is specific to applications.

kActionPushCurrentTime

none No Params

Places the current movie time onto the top of the movie controller's stack of times.

The movie controller maintains a stack data structure of movie times. The stack is manipulated using these actions.

kActionPushCurrentTimeWithLabel

none Param1: [Str255 theLabel]]

Pushes the current time onto the top of the movie controller's stack of times, along with a label. This label is not a chapter name, it is a tag that can be used in conjunction with kActionPopAndGotoLabeledTime .

kActionPopAndGotoTopTime

Supported Flags: none No Params

Retrieves the top time from the movie controller's stack of times and removes it from the stack. The movie's current time is then set to the time retrieved.

kActionPopAndGotoLabeledTime

Supported Flags: none Param1: [Str255 theLabel]

Searches from the top of the movie controller's stack of times towards the bottom until it finds a time with the specified label. If found, it removes all times from the top of the stack through the labeled time and sets the movie's current time to this time. Note that only the topmost time with a matching label is popped, not all occurrences times with the same label.